home *** CD-ROM | disk | FTP | other *** search
/ Precision Software Appli…tions Silver Collection 1 / Precision Software Applications Silver Collection Volume One (PSM) (1993).iso / tutor / pcl40.arj / PC-LEARN.DOC < prev    next >
Text File  |  1993-01-05  |  8KB  |  247 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                         PC-LEARN v4.0 by Mark E Linehan
  7.  
  8.  
  9.  
  10.                            Written in Turbo C++ v3.0
  11.  
  12.  
  13.  
  14.                          Created For Majestic Shareware
  15.  
  16.  
  17.  
  18.          (C)opyright 1992, 1993, by Mark E Linehan, All Rights Reserved
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29. DISCLAIMER: Majestic Shareware, including any representatives or authors, may
  30. not be held liable for any damages incurred through the use or misuse of this
  31. or any other software package. Users of this software are hereby notified that
  32. if they choose to use a program created by Majestic Shareware, and its authors
  33. they do so at their own risk, and receive no guarantees or warranty's of any
  34. kind expressed or implied here, or anywhere else.
  35.  
  36. Majestic Shareware operates with very low software costs and therefor it is not
  37. feasible for our company to make refunds on our software. If you find yourself
  38. unsatisfied with a purchase from Majestic Shareware please contact us and tell
  39. us what the problem seems to be, if we cannot correct it, then we will gladly
  40. give you a discount on your next purchase from Majestic Shareware.
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.             REGISTER PC-LEARN AND SUPPORT OUR GROUP FOR ONLY $10.00
  52.         This will get you the most recent update with full documentation
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65. Send $10.00 check or money order in U.S. funds to:
  66.  
  67.                                                    Mark Linehan
  68.                                                    32 Beaver Street
  69.                                                    Salem, MA 01970
  70.  
  71. PART I: What is PC-LEARN?
  72.  
  73.         PC-LEARN is a multi-function program created for a variety of usefull
  74. purposes. First and foremost it is intended as a type of tutorial maker. This
  75. is not its only purpose however. PC-LEARN can also be used to create TESTS,
  76. TRIVIA CHALLENGES, or just colorized, multi-screen text files with pauses page
  77. clearing, and more.
  78.  
  79.         PC-LEARN uses a .PCL file which is created using any plain ascii text
  80. editor, and it is easy to use in my opinion. You don't need any programming
  81. knowledge. PC-LEARN converts your ASCII file to a format it can recognize.
  82.  
  83.         Features of PC-LEARN are the ability to ask questions and track the
  84. number of correct and incorrect answers, start new pages with a screen clear,
  85. ending a page with a [Q]uit, any key to continue prompt, Changing text colors,
  86. beeping at the end of each line, asking true or false questions, as well as
  87. normal text response questions, and more. I am sure you can find a use for
  88. PC-LEARN. If nothing else you can easily create trivia to quiz your friends if
  89. you like. We at Majestic Shareware are currently working on several files
  90. which will serve as tutorials on various topics such as wine making, learning
  91. an introduction to C programming, and others.
  92.  
  93.  
  94. PART II: COMMANDS FOR PC-LEARN
  95.  
  96.         Here is a listing of the various commands you can insert into your
  97. text files to create a .PCL file.
  98.  
  99. [*ce    Centers text from that point on, or until you issue a [*le command.
  100.  
  101. [*sl    Toggles SLOW & NOISY display of text on and off.
  102.  
  103. [*le    Begins printing text from the far left column.
  104.  
  105. [*be    Toggles the BEEP at the end of each line on and off.
  106.  
  107. [*tr    Tells PCL to ask for a TRUE or FALSE response, TRUE being correct.
  108.  
  109. [*fa    Tells PCL to ask for a TRUE or FALSE response, FALSE being correct.
  110.  
  111. [*an    Prompts reader for a TEXT answer, the line following the [*an command
  112.         will be the answer PCL expects, and should be in UPPER CASE only.
  113.  
  114. [*t#    Sets the current text color.
  115.  
  116. [*t1    1 RED
  117.  
  118. [*t2    2 YELLOW
  119.  
  120. [*t3    3 GREEN
  121.  
  122. [*t4    4 BLUE
  123.  
  124. [*t5    5 WHITE
  125.  
  126. [*t6    6 BROWN
  127.  
  128. [*t7    7 MAGENTA
  129.  
  130. [*t8    8 LIGHT GRAY
  131.  
  132. [*cs    The next line in the file following this command will be stored in a
  133.         PCL variable so that you can invoke it at any point using the [*cp
  134.         command.
  135.  
  136. [*cp    Prints out the CONSTANT variable which was set using [*cs
  137.  
  138. [*c#    Sets CONSTANT variable's display color which will remain the same.
  139.         ( see [*t# for a listing of color codes )
  140.  
  141. [*ps    Clears the screen to begin a new page.
  142.  
  143. [*pa    Pauses until the reader hits a key
  144.  
  145. [*pe    Does a page end, prompts reader with [Q]uit, any other key to continue.
  146.  
  147. [*st    Display Correct/Incorrect answer statistics for the file thus far.
  148.  
  149. [*pr    Display Percentage of answers that were correct.
  150.  
  151. [*gr    Display a GRADE A,B,C,D,F according to correct answers.
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163. PART III: EXAMPLES OF COMMANDS
  164.  
  165. [start of file]
  166. [*ce                                    <- All text will now be centered
  167. [*t4                                    <- Text color changed to BLUE
  168. [*ps                                    <- Clears screen for new page
  169.                                         <- Blank line
  170. GREETINGS FROM PC-LEARN                 <- This line will be centered
  171.                                         <- Blank line
  172. [*pa                                    <- Pauses the program until a key hit
  173. [*le                                    <- Text is no longer centered now
  174. GREETINGS FROM PC-LEARN                 <- Printed from left side of screen
  175. [end of file]
  176.  
  177. This would appear [ with a cleared screen and the color blue ]:
  178.  
  179.                          GREETINGS FROM PC-LEARN
  180.  
  181. GREETINGS FROM PC-LEARN
  182.  
  183. As you can see that was a very simplistic example. Now let's look at something
  184. more in depth. How to ask questions!
  185.  
  186. [start of file]
  187. [*t5                                    <- Set color to WHITE
  188. PC-LEARN IS VERY USEFULL!               <- Displayed to screen
  189. [*tr                                    <- Prompt reader for a TRUE OR FALSE
  190.                                            answer, with TRUE being the proper
  191.                                            response. PC-LEARN automatically
  192.                                            counts the number of questions you
  193.                                            ask in your file.
  194. [*st                                    <- Display ANSWER statistics
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209. PART IV: COMPILING A .PCL FILE
  210.  
  211. Once you have completely written your ASCII file for PCL, you may then invoke
  212. the PC-LEARN compiler which will convert your text file into a format which
  213. it can interpret. Here is an example of using the compiler.
  214.  
  215. C:\PCLEARN> PCLC <your text file.asc> <finished file.pcl>
  216.  
  217. Notice you may use any extensions you want, but we recommend .asc for your file
  218. and .pcl for the compiled file. This makes keeping track a lot easier. Also,
  219. you may want to hold onto your .asc version of the .pcl file, because someone
  220. could easily look up the correct answers for your file, and that is not very
  221. nice. :)
  222.  
  223. Let's say I made an ascii file called TEST.ASC and I wanted to compile it for
  224. PC-LEARN I would type the following:
  225.  
  226. C:\PC-LEARN> PCLC TEST.ASC TEST.PCL
  227.  
  228. That's all there is to it. I think that should cover just about everything, if
  229. you need more examples there are several example .PCL files and .ASC files on
  230. this distribution diskette.
  231.  
  232. PART V: REGISTRATION
  233.  
  234. Notice this program is not crippled in any way, although I forced myself not to
  235. cripple it, I feel that if someone finds my software of use, and wants a better
  236. version and full documentation they'll send the small donation in. Considering
  237. the price of some software packages, I think $10.00 is very cheap. Not that I
  238. think PC-LEARN is any major achievement mind you, it's just time and effort on
  239. my behalf. BUT! Enough lecturing! Thanks for trying my program, and please
  240. support Majestic Shareware, we have plans on putting out MANY FINE programs
  241. from Arcade games to BBS programs. So even if you can't send $10.00, we will
  242. gladly accept software and hardware donations as well! By operating in this
  243. inexpensive method of shareware donations, we are able to charge very low
  244. prices!
  245.  
  246.  
  247.